<html>
  <head>
    <title>Translations in MonoDevelop</title>
  </head>
  <body>
    <h3>Introduction</h3>
	<p>MonoDevelop has chosen to use gettext instead of resources
	for translating into other languages.  This allows us to take
	advantage of GNOME translators familiarity with gettext and 
	other advantages.</p>
	<h3>Developers</h3>
	<p>Instead of using a string directly in your code, you just need
	to pass it to gettext which returns the translated string to you.
	<ol>
	  <li>Remember to encase all user visible strings, like so:<br />
	<code>GettextCatalog.GetString ("user visible string")</code><br />
	<code>String.Format (GettextCatalog.GetString ("user visible string {0}"), variable)</code>
	  </li>
	  <li>Add files with these strings to MonoDevelop/po/POTFILES.in</li>
	</ol>
	FIXME add info about checking for missing files in POTFILES.in
	glade, xml files
	</p>
	<h3>Translators</h3>
	<p>See <a href="http://www.gnome.org/i18n/">Gnome I18N</a> for
	information about the GNOME translation project.  Much of that
	material will also apply here.  In particular: <br />
	<ul>
      <li><a href="http://lcweb.loc.gov/standards/iso639-2/englangn.html">Language codes</a></li>
      <li><a href="http://developer.gnome.org/projects/gtp/resources.html">Resources</a></li>
	</ul>
	<ol>
	  //FIXME how do you do this:
	  <li>Create xx_XX.po (based on you Language code)</li>
	  <li>Translate the strings</li>
	  <li>add your language code to ALL_LINGUAS in configure.in</li>
	  <li>test by running <code>LANG=xx_XX monodevelop</code></li>
	</ol>
	</p>
	<h3>Credits, License, Errata</h3>
	<p>Send comments to <a href="mailto:jluke@cfl.rr.com">jluke@cfl.rr.com</a> or the <a href="mailto:monodevelop-list@lists.ximian.com">monodevelop mailing list</a>.</p>
	<p>Licensed under the <a href="http://opensource.org/licenses/mit-license.php">MIT License</a></p>
    <p>Last updated April 14, 2004</p>
  </body>
</html>

